home *** CD-ROM | disk | FTP | other *** search
/ ShareWare OnLine 2 / ShareWare OnLine Volume 2 (CMS Software)(1993).iso / music / qmod10.zip / MOD-OBJ.DOC < prev    next >
Text File  |  1993-06-03  |  9KB  |  250 lines
  1.      MODOBJ **********                                 (C) Mark J Cox
  2.      MODOBJ ***                                                  1992
  3.      MODOBJ *****
  4.      MODOBJ ****************                             Version 0.03
  5.  
  6.      Module playing OBJect file
  7.  
  8.  
  9.      I. QUICK START
  10.      ─────────────────────────────────────────────────────────
  11.     
  12.      The two included programs, TCMOD and TPMOD were created using
  13.      the unregistered version of MOD-OBJ under Turbo C v2.00 and
  14.      Turbo Pascal v6.0 respectively.   Look at the source code to see
  15.      how they work.
  16.  
  17.  
  18.      1. INTRODUCTION
  19.      ─────────────────────────────────────────────────────────
  20.  
  21.      The object file that is part of this package allows programmers
  22.      to add music and sound effects simply and easily to their programs.
  23.  
  24.      Music and sound effects can be played through a large number of
  25.      sound devices, including the PC Speaker, the Soundblaster and
  26.      various Covox devices.  
  27.  
  28.      Music plays in the background and there are a a huge number of
  29.      ready-made music modules available on the Amiga and the PC (*).
  30.  
  31.      Music modules are standard Amiga Noisetracker/ Startrekker/
  32.      Soundtracker/ Protracker modules.   A music module is made up of
  33.      up to 31 sampled instruments (instruments can also be things like
  34.      speech samples or effects).   Up to four of these instruments can
  35.      be played at once and are mixed to form the final sound output.  The
  36.      mixing is controlled from a music track,  which can playback notes
  37.      in sequence and perform numerous effects.
  38.  
  39.      The MODPLAY program (currently MPLAY219B) is a stand-alone player
  40.      for these modules on a PC.  It has graphical support, a real
  41.      spectrum analyser and much more. (And its freeware by Mark Cox)
  42.  
  43.      The MODEDIT program (currently MODED200) is a module creator/editor
  44.      and the documentation with Modedit explains in more detail the 
  45.      structure of the amiga modules. (also freeware by Norman Lin)
  46.  
  47.      Please note that not all Music modules can be treated as 'Public
  48.      Domain'.  Each module has a section that lists the names of all the
  49.      instruments and sometimes this includes a message from the author. 
  50.      Use MODEDIT/MODPLAY to view the messages (or use a file viewer on the
  51.      MOD file).  If a module has a message giving the module author, you
  52.      are advised to contact them before using their module for ANYTHING.
  53.  
  54.      You can obtain modules from many Bulletin Boards,  Internet sites or from
  55.      friends Amiga's.  Modules usually come archived in LZH form, these can be 
  56.      unpacked with the excellent LHA program.  
  57.  
  58.  
  59.  
  60.      2. SUPPORTED PROGRAMS
  61.      ─────────────────────────────────────────────────────────
  62.  
  63.      The OBJ file has been tested with the following software
  64.  
  65.      Turbo C v2.0    
  66.      Turbo Pascal v6.0
  67.  
  68.      but should work with most other C and Pascal compilers.
  69.      It will soon also support
  70.  
  71.      PowerBasic (formally Turbo Basic)
  72.  
  73.  
  74.      3. FEATURES
  75.      ─────────────────────────────────────────────────────────
  76.  
  77.         o Does not affect the clock, disk acesses or anything else
  78.  
  79.     o Allows samples to be played on a special '5th track' allowing
  80.       sound effects to be put over the top of the music.  
  81.       (registered version only)
  82.  
  83.         o Plays all Protracker 31 instrument module files. (Modules that
  84.           have 15 instruments can be converted using a program such as 
  85.       MODEDIT by Norman Lin.  It will also handle most Soundtracker/
  86.       Noisetracker and Startrekker (4 channel) modules, including ones
  87.       that have samples greater than 64k each in them.
  88.  
  89.         o Runs completely in the background, letting your program 
  90.           carry on as normal.
  91.  
  92.     o Plays through a wide range of output devices, including the
  93.           PC Speaker and Soundblaster
  94.  
  95.     o No royalties to pay for including it in your program (See
  96.       License agreement for details).
  97.  
  98.     o Module mixing speed can be altered to account for different
  99.           speed computers
  100.  
  101.  
  102.      4.  TECHNICAL
  103.      ─────────────────────────────────────────────────────────
  104.  
  105.      Technical details can be found in the technical documentation
  106.      TECH.DOC
  107.  
  108.  
  109.      5.  SHAREWARE
  110.      ─────────────────────────────────────────────────────────
  111.  
  112.      MODOBJ is shareware.  If you intend to use it in anything other
  113.      than public domain programs you should register it.  Registration
  114.      entitles you to the latest version of MOD-OBJ as well as the
  115.      ability to play sound samples over the top of the module and other
  116.      useful functions.  See the sections on registering and the license
  117.      agreement.
  118.  
  119.  
  120.  
  121.      6.  LICENCE AGREEMENT
  122.      ─────────────────────────────────────────────────────────
  123.  
  124.     Use of Mod-obj in a Personal or Public Domain Program
  125.     ──────────────────────────────────────────────────────
  126.  
  127.     The unregistered version of MODOBJ may be used in any public domain
  128.     programs (these are programs for which no fee is charged by the
  129.         author)  provided that this document is distributed with the programs
  130.         and that the author (Mark J Cox) receives credits within the program
  131.         and documentation.
  132.     You are strongly urged to register to get the extra routines 
  133.     provided by the registered version however.  
  134.  
  135.     The registered version of MODOBJ may be used in your public domain
  136.         programs freely without the need to include this document as long
  137.         as the author (Mark J Cox) recieves credits within the program and
  138.         documentation.
  139.  
  140.     Use of MODOBJ in Shareware Programs
  141.     ──────────────────────────────────────────────────────
  142.  
  143.     The unregistered version of MODOBJ may not be used in any Shareware
  144.     (fee charged for the software) programs.  
  145.  
  146.     Registering your version of MODOBJ will entitle you to include 
  147.     MODOBJ in your shareware programs as long as the author (Mark J Cox)
  148.         receives credits both within the program and the documentation.
  149.  
  150.  
  151.     Use of MODOBJ in Commercial Programs
  152.     ──────────────────────────────────────────────────────
  153.  
  154.     The unregistered version of MODOBJ may not be used in any commercial
  155.     programs.  
  156.  
  157.     The registered version may be used where agreed in writing
  158.     by the author.  (This will not involve royalty payments, just a 
  159.     one-off fee;  contact the author).
  160.  
  161.  
  162.      7.  COPYRIGHT/LICENCE AGREEMENT
  163.      ──────────────────────────────────────────────────────
  164.  
  165.      The files MOD-OBJ.DOC, TECH.DOC, MOD-OBJ.OBJ  are copyrighted by 
  166.      Mark J Cox.  You are free to distribute the unregistered version
  167.      of the MOD-OBJ package as you wish provided no profit is made from
  168.      the distribution.
  169.  
  170.      The copyright owner hereby licenses you to use this software
  171.      as stated in section 6 of this document.
  172.  
  173.      ║ NEITHER THE MODOBJ PROGRAM OR DOCUMENTATION MAY BE ALTERED         ║
  174.      ║ IN ANY WAY, OR REVERSE-ENGINEERED BY DISASSEMBLY OR OTHER METHOD.  ║
  175.  
  176.      There is no warranty of any kind, and the copyright owner is not liable
  177.      for damages of any kind.  By using this software, you agree to 
  178.      all the above terms.
  179.     
  180.      The software and documentation are
  181.      Copyright (C) 1992 by Mark J Cox
  182.  
  183.     Mark J Cox
  184.     29 Lundie Close
  185.     Stenson Fields
  186.     Derby DE2 3AN.
  187.  
  188.  
  189.  
  190.      8.  ELECTRONIC MAIL
  191.      ──────────────────────────────────────────────────────
  192.  
  193.      You can contact me via electronic mail
  194.  
  195.     m.j.h.cox@bradford.ac.uk        (probably until 1995)
  196.  
  197.      If that fails, as a last resort try
  198.  
  199.        bc732@cleveland.freenet.edu
  200.  
  201.      An excellent dial-up BBS in the UK (Derby) is
  202.  
  203.     Kingdom of Greyhawk,  +44 332 756414  (0332 756414 UK)
  204.     its got loads of stuff on it, and in the past was voted top
  205.       UK BBS.  Friendly sysop Alan Coates is waiting for your 
  206.     call (300-14k4) - mention you heard about it from Mark Cox! 
  207.  
  208.      You can check to see if I'm still registered by calling Bradford's
  209.      Information Server;  telnet to
  210.  
  211.     info.bradford.ac.uk
  212.  
  213.      And log in as user "info"
  214.  
  215.  
  216.      8.  REGISTRATION
  217.      ──────────────────────────────────────────────────────
  218.  
  219.      To register your version of MODOBJ, send a cheque or postal
  220.      order payable to "Mark Cox" to the address is section 6
  221.  
  222.      Registration includes a diskette containing some more sample
  223.      programs, and a registered version of MODOBJ with the extra
  224.      facilities listed in this document.  Please state if you want
  225.      5.25" diskette instead of usual 3.5"
  226.  
  227.  
  228.      Cheque in UK currency (Sterling):        
  229.         15 pounds
  230.  
  231.      Cheque in US dollars:     
  232.         30 US dollars
  233.  
  234.      Outside UK (other currency):
  235.         17 pounds * Current Exchange rate + 10% for fluctuations
  236.         If unsure, contact me for an estimate.
  237.  
  238.  
  239.      Coming soon:
  240.  
  241.     Power Basic version (maybe, I'm having problems allocating more
  242.                              than 31K at a time)
  243.  
  244.     Soundblaster Pro support (at the moment works - but in mono)
  245.     Adlib Gold support
  246.         Pro Audio Spectrum support
  247.  
  248.     If you have programming details for the above cards (or any other
  249.         new cards) let me know - Its worth a free registration to the first!
  250.